<!DOCTYPE html>
<html lang="en-US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<title>do_ocr_single_class_knn [HALCON算子参考手册]</title>
<style type="text/css">
      body {
    color: #000000;
    background-color: #ffffff;
    margin: 0;
    font-family: Arial, Helvetica, sans-serif;
}

.body_main {
    margin-left: 35px;
    margin-right: 35px;
}

@media screen and (min-width:992px) {

    .body_main {
        margin-left: 10%;
        margin-right: 10%;
    }

    table.toctable {
        width: 80%
    }
}

@media screen and (min-width:1400px) {

    .body_main {
        margin-left: 15%;
        margin-right: 15%;
    }

    table.toctable {
        width: 70%
    }
}

body>div ul ul {
    margin-left: inherit;
}

a:link {
    color: #0044cc;
}

a:link,
a:visited {
    text-decoration: none;
}

a:link:hover,
a:visited:hover {
    text-decoration: underline;
}

th {
    text-align: left;
}

h1,
h2,
h3,
h4,
h5,
h6 {
    text-rendering: optimizeLegibility;
    color: #666666;
}

code {
    font-family: monospace,monospace;
}

h1 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

h2 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

hr {
    border: 0;
    border-top: solid 1px #f28d26;
}

.pre {
    display: block;
    padding-bottom: 1ex;
    font-family: monospace;
    white-space: pre;
}

pre {
    font-family: monospace, monospace;
    padding: 1ex;
    white-space: pre-wrap;
}

.toc {
    font-size: 80%;
    border-top: 1px dashed #f28d26;
    border-bottom: 1px dashed #f28d26;
    padding-top: 5px;
    padding-bottom: 5px;
}

.inv {
    margin: 0;
    border: 0;
    padding: 0;
}

.banner {
    color: #666666;
    padding-left: 1em;
}

.logo {
    background-color: white;
}

.keyboard {
    font-size: 80%;
    padding-left: 3px;
    padding-right: 3px;
    border-radius: 5px;
    border-width: 1px;
    border-style: solid;
    border-color: #f28d26;
    background-color: #f3f3f3;
}

.warning {
    margin-top: 2ex;
    margin-bottom: 1ex;
    padding: 10px;
    text-align: center;
    border: 1px solid;
    color: #bb0000;
    background-color: #fff7f7
}

.imprint {
    margin-top: 1ex;
    font-size: 80%;
    color: #666666;
}

.imprinthead {
    font-weight: bolder;
    color: #666666;
}

.indexlink {
    text-align: right;
    padding-bottom: 5px;
}

.postscript {
    margin-top: 2ex;
    font-size: 80%;
    color: #666666
}

.evenrow {
    background-color: #e7e7ef;
    vertical-align: top;
}

.oddrow {
    background-color: #f7f7ff;
    vertical-align: top;
}

.headrow {
    background-color: #97979f;
    color: #ffffff;
    vertical-align: top;
}

.logorow {
    vertical-align: top;
}

.error {
    color: red;
}

.var {
    font-style: italic
}

.halconoperator {
    font-family: monospace, monospace;
}

span.operator {
    font-family: monospace, monospace;
}

span.procedure {
    font-family: monospace, monospace;
}

span.operation {
    font-family: monospace, monospace;
}

span.feature {
    font-family: Arial, Helvetica, Homerton, sans-serif;
}

ul {
    padding-left: 1.2em;
}

li.dot {
    list-style-type: square;
    color: #f28d26;
}

.breadcrumb {
    font-size: 80%;
    color: white;
    background-color: #062d64;
    margin-bottom: 20px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 15px;
}

.webbar {
    font-size: 80%;
    background-color: #dddddd;
    margin-top: 0px;
    margin-left: -35px;
    margin-right: -35px;
    margin-bottom: 0px;
    padding-top: 5px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 5px;
}

.footer {
    display: flex;
    flex-wrap: wrap;
    justify-content: space-between;
    border-top: 1px dashed #f28d26;
    font-size: 80%;
    color: #666666;
    padding-bottom: 8px;
}

.footer .socialmedia a {
    padding-left: 7px;
}

.socialmedia {
    padding-top: 10px;
}

.copyright {
    margin-top: 19px;
}

.breadcrumb a {
    color: #ffffff;
    border-bottom: 1px solid white;
}

.breadcrumb a:link:hover,
.breadcrumb a:visited:hover {
    text-decoration: none;
    border-bottom: none;
}

.heading {
    margin-top: 1ex;
    font-size: 110%;
    font-weight: bold;
    color: #666666;
}

.text {
    color: black;
}

.example {
    font-size: 80%;
    background-color: #f3f3f3;
    border: 1px dashed #666666;
    padding: 10px;
}

.displaymath {
    display: block;
    text-align: center;
    margin-top: 1ex;
    margin-bottom: 1ex;
}

.title {
    float: left;
    padding-top: 3px;
    padding-bottom: 3px;
}

.signnote {
    font-family: Arial, Helvetica, Homerton, sans-serif;
    font-size: 80%;
    color: #666666;
    font-weight: lighter;
    font-style: italic
}

.par {
    margin-bottom: 1.5em;
}

.parhead {
    text-align: right;
}

.parname {
    float: left;
}

.pardesc {
    font-size: 85%;
    margin-top: 0.5em;
    margin-bottom: 0.5em;
    margin-left: 2em;
}

.parcat {
    color: #666;
    font-weight: bold;
}

*[data-if=cpp],
*[data-if=c],
*[data-if=dotnet],
*[data-if=com],
*[data-if=python] {
    display: none;
}

.tabbar {
    text-align: right;
    border-bottom: 1px solid #f28d26;
    margin-bottom: 0.5em;
}

ul.tabs {
    padding-top: 3px;
    padding-bottom: 3px;
    margin-top: 10px;
    margin-bottom: 0;
    font-size: 80%
}

ul.tabs li {
    padding-top: 3px;
    padding-bottom: 3px;
    display: inline;
    overflow: hidden;
    list-style-type: none;
    margin: 0;
    margin-left: 8px;
    border-top: 1px solid #666;
    border-left: 1px solid #666;
    border-right: 1px solid #666;
}

ul.tabs li.active {
    border-left: 1px solid #f28d26;
    border-right: 1px solid #f28d26;
    border-top: 1px solid #f28d26;
    border-bottom: 1px solid #fff;
}

ul.tabs li.inactive {
    background-color: #eee;
}

ul.tabs li a {
    padding-left: 5px;
    padding-right: 5px;
    color: #666;
}

ul.tabs li a:link:hover {
    text-decoration: none;
}

ul.tabs li.inactive a {
    color: #666;
}

ul.tabs li.active a {
    color: black;
}

dl.generic dd {
    margin-bottom: 1em;
}

.pari {
    color: olive;
}

.paro {
    color: maroon;
}

.comment {
    font-size: 80%;
    color: green;
    white-space: nowrap;
}

table.grid {
    border-collapse: collapse;
}

table.grid td {
    padding: 5px;
    border: 1px solid;
}

table.layout {
    border: 0px;
}

table.layout td {
    padding: 5px;
}

table.table {
    border-collapse: collapse;
}

table.table td {
    padding: 5px;
    border-left: 0px;
    border-right: 0px;
}

table.table tr:last-child {
    border-bottom: 1px solid;
}

table.table th {
    padding: 5px;
    border-top: 1px solid;
    border-bottom: 1px solid;
    border-left: 0px;
    border-right: 0px;
}

.details_summary {
    cursor: pointer;
}

table.toctable {
    width: 100%;
}

table.toctable col:first-child {
    width: 20%;
}

table.toctable col:nth-last-child(2) {
    width: 8%;
}

table.altcolored tr:nth-child(even) {
    background-color: #f3f3f3;
}

    </style>
<!--OP_REF_STYLE_END-->
<script>
    <!--
var active_lang='hdevelop';function switchVisibility(obj,active_lang,new_lang)
{var display_style='inline';
for(var i=0;i<obj.length;i++)
{if(obj.item(i).getAttribute('data-if')==new_lang)
{obj.item(i).style.display=display_style;}
if(obj.item(i).getAttribute('data-if')==active_lang)
{obj.item(i).style.display='none';}}
return;}
function toggleLanguage(new_lang,initial)
{if(active_lang!=new_lang)
{var lis=document.getElementsByTagName('li');for(var i=0;i<lis.length;i++)
{if(lis.item(i).id=='syn-'+new_lang)
{lis.item(i).className='active';}
else
{lis.item(i).className='inactive';}}
var divs=document.getElementsByTagName('div');var spans=document.getElementsByTagName('span');switchVisibility(divs,active_lang,new_lang);switchVisibility(spans,active_lang,new_lang);if(!initial)
{setCookie("halcon_reference_language",new_lang,null,null);}
active_lang=new_lang;}
return;}
function setCookie(name,value,domain,exp_offset,path,secure)
{localStorage.setItem(name,value);}
function getCookie(name)
{return localStorage.getItem(name);}
function initialize()
{var qs=location.href.split('?')[1];var qs_lang_raw=location.href.split('interface=')[1];var qs_lang;if(qs_lang_raw)
{qs_lang=qs_lang_raw.split('#')[0];}
var cookie_lang=getCookie("halcon_reference_language");var new_lang;if((qs_lang=="hdevelop")||(qs_lang=="dotnet")||(qs_lang=="python")||(qs_lang=="cpp")||(qs_lang=="c"))
{new_lang=qs_lang;setCookie("halcon_reference_language",new_lang,null,null);}
else if((cookie_lang=="hdevelop")||(cookie_lang=="dotnet")||(cookie_lang=="python")||(cookie_lang=="cpp")||(cookie_lang=="c"))
{new_lang=cookie_lang;}
else
{new_lang="hdevelop";}
toggleLanguage(new_lang,1);return;}
-->

  </script>
</head>
<body onload="initialize();">
<div class="breadcrumb">
<br class="inv"><a href="index.html">目录</a> / <a href="toc_ocr.html">OCR</a> / <a href="toc_ocr_knearestneighbor.html">K-最近邻</a><br class="inv">
</div>
<div class="body_main">
<div class="tabbar"><ul class="tabs">
<li id="syn-hdevelop" class="active"><a href="javascript:void(0);" onclick="toggleLanguage('hdevelop')" onfocus="blur()">HDevelop</a></li>
<li id="syn-dotnet" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('dotnet')" onfocus="blur()">.NET</a></li>
<li id="syn-python" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('python')" onfocus="blur()">Python</a></li>
<li id="syn-cpp" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('cpp')" onfocus="blur()">C++</a></li>
<li id="syn-c" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('c')" onfocus="blur()">C</a></li>
</ul></div>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<!--OP_REF_HEADER_END-->
<h1 id="sec_name">
<span data-if="hdevelop" style="display:inline;">do_ocr_single_class_knn</span><span data-if="c" style="display:none;">T_do_ocr_single_class_knn</span><span data-if="cpp" style="display:none;">DoOcrSingleClassKnn</span><span data-if="dotnet" style="display:none;">DoOcrSingleClassKnn</span><span data-if="python" style="display:none;">do_ocr_single_class_knn</span> (算子名称)</h1>
<h2>名称</h2>
<p><code><span data-if="hdevelop" style="display:inline;">do_ocr_single_class_knn</span><span data-if="c" style="display:none;">T_do_ocr_single_class_knn</span><span data-if="cpp" style="display:none;">DoOcrSingleClassKnn</span><span data-if="dotnet" style="display:none;">DoOcrSingleClassKnn</span><span data-if="python" style="display:none;">do_ocr_single_class_knn</span></code> — Classify a single character with an OCR classifier.</p>
<h2 id="sec_synopsis">参数签名</h2>
<div data-if="hdevelop" style="display:inline;">
<p>
<code><b>do_ocr_single_class_knn</b>(<a href="#Character"><i>Character</i></a>, <a href="#Image"><i>Image</i></a> :  : <a href="#OCRHandle"><i>OCRHandle</i></a>, <a href="#NumClasses"><i>NumClasses</i></a>, <a href="#NumNeighbors"><i>NumNeighbors</i></a> : <a href="#Class"><i>Class</i></a>, <a href="#Confidence"><i>Confidence</i></a>)</code></p>
</div>
<div data-if="c" style="display:none;">
<p>
<code>Herror <b>T_do_ocr_single_class_knn</b>(const Hobject <a href="#Character"><i>Character</i></a>, const Hobject <a href="#Image"><i>Image</i></a>, const Htuple <a href="#OCRHandle"><i>OCRHandle</i></a>, const Htuple <a href="#NumClasses"><i>NumClasses</i></a>, const Htuple <a href="#NumNeighbors"><i>NumNeighbors</i></a>, Htuple* <a href="#Class"><i>Class</i></a>, Htuple* <a href="#Confidence"><i>Confidence</i></a>)</code></p>
</div>
<div data-if="cpp" style="display:none;">
<p>
<code>void <b>DoOcrSingleClassKnn</b>(const HObject&amp; <a href="#Character"><i>Character</i></a>, const HObject&amp; <a href="#Image"><i>Image</i></a>, const HTuple&amp; <a href="#OCRHandle"><i>OCRHandle</i></a>, const HTuple&amp; <a href="#NumClasses"><i>NumClasses</i></a>, const HTuple&amp; <a href="#NumNeighbors"><i>NumNeighbors</i></a>, HTuple* <a href="#Class"><i>Class</i></a>, HTuple* <a href="#Confidence"><i>Confidence</i></a>)</code></p>
<p>
<code><a href="HTuple.html">HTuple</a> <a href="HRegion.html">HRegion</a>::<b>DoOcrSingleClassKnn</b>(const HImage&amp; <a href="#Image"><i>Image</i></a>, const HOCRKnn&amp; <a href="#OCRHandle"><i>OCRHandle</i></a>, const HTuple&amp; <a href="#NumClasses"><i>NumClasses</i></a>, const HTuple&amp; <a href="#NumNeighbors"><i>NumNeighbors</i></a>, HTuple* <a href="#Confidence"><i>Confidence</i></a>) const</code></p>
<p>
<code>HString <a href="HRegion.html">HRegion</a>::<b>DoOcrSingleClassKnn</b>(const HImage&amp; <a href="#Image"><i>Image</i></a>, const HOCRKnn&amp; <a href="#OCRHandle"><i>OCRHandle</i></a>, const HTuple&amp; <a href="#NumClasses"><i>NumClasses</i></a>, const HTuple&amp; <a href="#NumNeighbors"><i>NumNeighbors</i></a>, double* <a href="#Confidence"><i>Confidence</i></a>) const</code></p>
<p>
<code><a href="HTuple.html">HTuple</a> <a href="HOCRKnn.html">HOCRKnn</a>::<b>DoOcrSingleClassKnn</b>(const HRegion&amp; <a href="#Character"><i>Character</i></a>, const HImage&amp; <a href="#Image"><i>Image</i></a>, const HTuple&amp; <a href="#NumClasses"><i>NumClasses</i></a>, const HTuple&amp; <a href="#NumNeighbors"><i>NumNeighbors</i></a>, HTuple* <a href="#Confidence"><i>Confidence</i></a>) const</code></p>
<p>
<code>HString <a href="HOCRKnn.html">HOCRKnn</a>::<b>DoOcrSingleClassKnn</b>(const HRegion&amp; <a href="#Character"><i>Character</i></a>, const HImage&amp; <a href="#Image"><i>Image</i></a>, const HTuple&amp; <a href="#NumClasses"><i>NumClasses</i></a>, const HTuple&amp; <a href="#NumNeighbors"><i>NumNeighbors</i></a>, double* <a href="#Confidence"><i>Confidence</i></a>) const</code></p>
</div>
<div data-if="com" style="display:none;"></div>
<div data-if="dotnet" style="display:none;">
<p>
<code>static void <a href="HOperatorSet.html">HOperatorSet</a>.<b>DoOcrSingleClassKnn</b>(<a href="HObject.html">HObject</a> <a href="#Character"><i>character</i></a>, <a href="HObject.html">HObject</a> <a href="#Image"><i>image</i></a>, <a href="HTuple.html">HTuple</a> <a href="#OCRHandle"><i>OCRHandle</i></a>, <a href="HTuple.html">HTuple</a> <a href="#NumClasses"><i>numClasses</i></a>, <a href="HTuple.html">HTuple</a> <a href="#NumNeighbors"><i>numNeighbors</i></a>, out <a href="HTuple.html">HTuple</a> <a href="#Class"><i>classVal</i></a>, out <a href="HTuple.html">HTuple</a> <a href="#Confidence"><i>confidence</i></a>)</code></p>
<p>
<code><a href="HTuple.html">HTuple</a> <a href="HRegion.html">HRegion</a>.<b>DoOcrSingleClassKnn</b>(<a href="HImage.html">HImage</a> <a href="#Image"><i>image</i></a>, <a href="HOCRKnn.html">HOCRKnn</a> <a href="#OCRHandle"><i>OCRHandle</i></a>, <a href="HTuple.html">HTuple</a> <a href="#NumClasses"><i>numClasses</i></a>, <a href="HTuple.html">HTuple</a> <a href="#NumNeighbors"><i>numNeighbors</i></a>, out <a href="HTuple.html">HTuple</a> <a href="#Confidence"><i>confidence</i></a>)</code></p>
<p>
<code>string <a href="HRegion.html">HRegion</a>.<b>DoOcrSingleClassKnn</b>(<a href="HImage.html">HImage</a> <a href="#Image"><i>image</i></a>, <a href="HOCRKnn.html">HOCRKnn</a> <a href="#OCRHandle"><i>OCRHandle</i></a>, <a href="HTuple.html">HTuple</a> <a href="#NumClasses"><i>numClasses</i></a>, <a href="HTuple.html">HTuple</a> <a href="#NumNeighbors"><i>numNeighbors</i></a>, out double <a href="#Confidence"><i>confidence</i></a>)</code></p>
<p>
<code><a href="HTuple.html">HTuple</a> <a href="HOCRKnn.html">HOCRKnn</a>.<b>DoOcrSingleClassKnn</b>(<a href="HRegion.html">HRegion</a> <a href="#Character"><i>character</i></a>, <a href="HImage.html">HImage</a> <a href="#Image"><i>image</i></a>, <a href="HTuple.html">HTuple</a> <a href="#NumClasses"><i>numClasses</i></a>, <a href="HTuple.html">HTuple</a> <a href="#NumNeighbors"><i>numNeighbors</i></a>, out <a href="HTuple.html">HTuple</a> <a href="#Confidence"><i>confidence</i></a>)</code></p>
<p>
<code>string <a href="HOCRKnn.html">HOCRKnn</a>.<b>DoOcrSingleClassKnn</b>(<a href="HRegion.html">HRegion</a> <a href="#Character"><i>character</i></a>, <a href="HImage.html">HImage</a> <a href="#Image"><i>image</i></a>, <a href="HTuple.html">HTuple</a> <a href="#NumClasses"><i>numClasses</i></a>, <a href="HTuple.html">HTuple</a> <a href="#NumNeighbors"><i>numNeighbors</i></a>, out double <a href="#Confidence"><i>confidence</i></a>)</code></p>
</div>
<div data-if="python" style="display:none;">
<p>
<code>def <b>do_ocr_single_class_knn</b>(<a href="#Character"><i>character</i></a>: HObject, <a href="#Image"><i>image</i></a>: HObject, <a href="#OCRHandle"><i>ocrhandle</i></a>: HHandle, <a href="#NumClasses"><i>num_classes</i></a>: Sequence[int], <a href="#NumNeighbors"><i>num_neighbors</i></a>: Sequence[int]) -&gt; Tuple[Sequence[str], Sequence[float]]</code></p>
<p>
<code>def <b>do_ocr_single_class_knn_s</b>(<a href="#Character"><i>character</i></a>: HObject, <a href="#Image"><i>image</i></a>: HObject, <a href="#OCRHandle"><i>ocrhandle</i></a>: HHandle, <a href="#NumClasses"><i>num_classes</i></a>: Sequence[int], <a href="#NumNeighbors"><i>num_neighbors</i></a>: Sequence[int]) -&gt; Tuple[str, float]</code></p>
</div>
<h2 id="sec_description">描述</h2>
<p><code><span data-if="hdevelop" style="display:inline">do_ocr_single_class_knn</span><span data-if="c" style="display:none">do_ocr_single_class_knn</span><span data-if="cpp" style="display:none">DoOcrSingleClassKnn</span><span data-if="com" style="display:none">DoOcrSingleClassKnn</span><span data-if="dotnet" style="display:none">DoOcrSingleClassKnn</span><span data-if="python" style="display:none">do_ocr_single_class_knn</span></code> uses the  OCR-k-NN classifier
<a href="#OCRHandle"><i><code><span data-if="hdevelop" style="display:inline">OCRHandle</span><span data-if="c" style="display:none">OCRHandle</span><span data-if="cpp" style="display:none">OCRHandle</span><span data-if="com" style="display:none">OCRHandle</span><span data-if="dotnet" style="display:none">OCRHandle</span><span data-if="python" style="display:none">ocrhandle</span></code></i></a> to determine the best training samples for the
features of the character given by the region <a href="#Character"><i><code><span data-if="hdevelop" style="display:inline">Character</span><span data-if="c" style="display:none">Character</span><span data-if="cpp" style="display:none">Character</span><span data-if="com" style="display:none">Character</span><span data-if="dotnet" style="display:none">character</span><span data-if="python" style="display:none">character</span></code></i></a> and
the gray values <a href="#Image"><i><code><span data-if="hdevelop" style="display:inline">Image</span><span data-if="c" style="display:none">Image</span><span data-if="cpp" style="display:none">Image</span><span data-if="com" style="display:none">Image</span><span data-if="dotnet" style="display:none">image</span><span data-if="python" style="display:none">image</span></code></i></a> and returns their classes in
<a href="#Class"><i><code><span data-if="hdevelop" style="display:inline">Class</span><span data-if="c" style="display:none">Class</span><span data-if="cpp" style="display:none">Class</span><span data-if="com" style="display:none">Class</span><span data-if="dotnet" style="display:none">classVal</span><span data-if="python" style="display:none">class</span></code></i></a> and the corresponding confidences in <a href="#Confidence"><i><code><span data-if="hdevelop" style="display:inline">Confidence</span><span data-if="c" style="display:none">Confidence</span><span data-if="cpp" style="display:none">Confidence</span><span data-if="com" style="display:none">Confidence</span><span data-if="dotnet" style="display:none">confidence</span><span data-if="python" style="display:none">confidence</span></code></i></a>.
If the first <a href="#NumNeighbors"><i><code><span data-if="hdevelop" style="display:inline">NumNeighbors</span><span data-if="c" style="display:none">NumNeighbors</span><span data-if="cpp" style="display:none">NumNeighbors</span><span data-if="com" style="display:none">NumNeighbors</span><span data-if="dotnet" style="display:none">numNeighbors</span><span data-if="python" style="display:none">num_neighbors</span></code></i></a> training vectors have different classes,
maximally <a href="#NumClasses"><i><code><span data-if="hdevelop" style="display:inline">NumClasses</span><span data-if="c" style="display:none">NumClasses</span><span data-if="cpp" style="display:none">NumClasses</span><span data-if="com" style="display:none">NumClasses</span><span data-if="dotnet" style="display:none">numClasses</span><span data-if="python" style="display:none">num_classes</span></code></i></a> classes are returned sorted by frequency
and weighted distance.
The confidences lie between 0.0 and 1.0. The larger the value, the
more reliable is the classification.
The confidence can be only computed robustly
if <a href="#NumNeighbors"><i><code><span data-if="hdevelop" style="display:inline">NumNeighbors</span><span data-if="c" style="display:none">NumNeighbors</span><span data-if="cpp" style="display:none">NumNeighbors</span><span data-if="com" style="display:none">NumNeighbors</span><span data-if="dotnet" style="display:none">numNeighbors</span><span data-if="python" style="display:none">num_neighbors</span></code></i></a> is large enough.
</p>
<p>Because multiple classes may be returned by
<code><span data-if="hdevelop" style="display:inline">do_ocr_single_class_knn</span><span data-if="c" style="display:none">do_ocr_single_class_knn</span><span data-if="cpp" style="display:none">DoOcrSingleClassKnn</span><span data-if="com" style="display:none">DoOcrSingleClassKnn</span><span data-if="dotnet" style="display:none">DoOcrSingleClassKnn</span><span data-if="python" style="display:none">do_ocr_single_class_knn</span></code>, <a href="#Character"><i><code><span data-if="hdevelop" style="display:inline">Character</span><span data-if="c" style="display:none">Character</span><span data-if="cpp" style="display:none">Character</span><span data-if="com" style="display:none">Character</span><span data-if="dotnet" style="display:none">character</span><span data-if="python" style="display:none">character</span></code></i></a> may only contain
a single region (a single character).  If multiple characters should
be classified in a single call, <a href="do_ocr_multi_class_knn.html"><code><span data-if="hdevelop" style="display:inline">do_ocr_multi_class_knn</span><span data-if="c" style="display:none">do_ocr_multi_class_knn</span><span data-if="cpp" style="display:none">DoOcrMultiClassKnn</span><span data-if="com" style="display:none">DoOcrMultiClassKnn</span><span data-if="dotnet" style="display:none">DoOcrMultiClassKnn</span><span data-if="python" style="display:none">do_ocr_multi_class_knn</span></code></a> must
be used. Before calling <code><span data-if="hdevelop" style="display:inline">do_ocr_single_class_knn</span><span data-if="c" style="display:none">do_ocr_single_class_knn</span><span data-if="cpp" style="display:none">DoOcrSingleClassKnn</span><span data-if="com" style="display:none">DoOcrSingleClassKnn</span><span data-if="dotnet" style="display:none">DoOcrSingleClassKnn</span><span data-if="python" style="display:none">do_ocr_single_class_knn</span></code>, the classifier must
be trained with <a href="trainf_ocr_class_knn.html"><code><span data-if="hdevelop" style="display:inline">trainf_ocr_class_knn</span><span data-if="c" style="display:none">trainf_ocr_class_knn</span><span data-if="cpp" style="display:none">TrainfOcrClassKnn</span><span data-if="com" style="display:none">TrainfOcrClassKnn</span><span data-if="dotnet" style="display:none">TrainfOcrClassKnn</span><span data-if="python" style="display:none">trainf_ocr_class_knn</span></code></a> or
<a href="select_feature_set_trainf_knn.html"><code><span data-if="hdevelop" style="display:inline">select_feature_set_trainf_knn</span><span data-if="c" style="display:none">select_feature_set_trainf_knn</span><span data-if="cpp" style="display:none">SelectFeatureSetTrainfKnn</span><span data-if="com" style="display:none">SelectFeatureSetTrainfKnn</span><span data-if="dotnet" style="display:none">SelectFeatureSetTrainfKnn</span><span data-if="python" style="display:none">select_feature_set_trainf_knn</span></code></a>.
If all <a href="#NumNeighbors"><i><code><span data-if="hdevelop" style="display:inline">NumNeighbors</span><span data-if="c" style="display:none">NumNeighbors</span><span data-if="cpp" style="display:none">NumNeighbors</span><span data-if="com" style="display:none">NumNeighbors</span><span data-if="dotnet" style="display:none">numNeighbors</span><span data-if="python" style="display:none">num_neighbors</span></code></i></a> neighbors are of the same class, only
one class is returned.</p>
<h2 id="sec_execution">运行信息</h2>
<ul>
  <li>多线程类型:可重入(与非独占操作符并行运行)。</li>
<li>多线程作用域:全局(可以从任何线程调用)。</li>
  <li>未经并行化处理。</li>
</ul>
<h2 id="sec_parameters">参数表</h2>
  <div class="par">
<div class="parhead">
<span id="Character" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Character</span><span data-if="c" style="display:none">Character</span><span data-if="cpp" style="display:none">Character</span><span data-if="com" style="display:none">Character</span><span data-if="dotnet" style="display:none">character</span><span data-if="python" style="display:none">character</span></code></b> (input_object)  </span><span>region <code>→</code> <span data-if="hdevelop" style="display:inline">object</span><span data-if="dotnet" style="display:none"><a href="HRegion.html">HRegion</a></span><span data-if="python" style="display:none">HObject</span><span data-if="cpp" style="display:none"><a href="HRegion.html">HRegion</a></span><span data-if="c" style="display:none">Hobject</span></span>
</div>
<p class="pardesc">Character to be recognized.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="Image" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Image</span><span data-if="c" style="display:none">Image</span><span data-if="cpp" style="display:none">Image</span><span data-if="com" style="display:none">Image</span><span data-if="dotnet" style="display:none">image</span><span data-if="python" style="display:none">image</span></code></b> (input_object)  </span><span>singlechannelimage <code>→</code> <span data-if="hdevelop" style="display:inline">object</span><span data-if="dotnet" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="python" style="display:none">HObject</span><span data-if="cpp" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="c" style="display:none">Hobject</span> (byte / uint2)</span>
</div>
<p class="pardesc">Gray values of the character.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="OCRHandle" class="parname"><b><code><span data-if="hdevelop" style="display:inline">OCRHandle</span><span data-if="c" style="display:none">OCRHandle</span><span data-if="cpp" style="display:none">OCRHandle</span><span data-if="com" style="display:none">OCRHandle</span><span data-if="dotnet" style="display:none">OCRHandle</span><span data-if="python" style="display:none">ocrhandle</span></code></b> (input_control)  </span><span>ocr_knn <code>→</code> <span data-if="dotnet" style="display:none"><a href="HOCRKnn.html">HOCRKnn</a>, </span><span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">HHandle</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (handle)</span><span data-if="dotnet" style="display:none"> (<i>IntPtr</i>)</span><span data-if="cpp" style="display:none"> (<i>HHandle</i>)</span><span data-if="c" style="display:none"> (<i>handle</i>)</span></span>
</div>
<p class="pardesc">Handle of the k-NN classifier.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="NumClasses" class="parname"><b><code><span data-if="hdevelop" style="display:inline">NumClasses</span><span data-if="c" style="display:none">NumClasses</span><span data-if="cpp" style="display:none">NumClasses</span><span data-if="com" style="display:none">NumClasses</span><span data-if="dotnet" style="display:none">numClasses</span><span data-if="python" style="display:none">num_classes</span></code></b> (input_control)  </span><span>integer-array <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">Sequence[int]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Number of maximal classes to determine.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>1</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span>1, 2, 3, 4, 5</p>
</div>
  <div class="par">
<div class="parhead">
<span id="NumNeighbors" class="parname"><b><code><span data-if="hdevelop" style="display:inline">NumNeighbors</span><span data-if="c" style="display:none">NumNeighbors</span><span data-if="cpp" style="display:none">NumNeighbors</span><span data-if="com" style="display:none">NumNeighbors</span><span data-if="dotnet" style="display:none">numNeighbors</span><span data-if="python" style="display:none">num_neighbors</span></code></b> (input_control)  </span><span>integer-array <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">Sequence[int]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Number of neighbors to consider.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>1</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span>1, 2, 3, 4, 5</p>
</div>
  <div class="par">
<div class="parhead">
<span id="Class" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Class</span><span data-if="c" style="display:none">Class</span><span data-if="cpp" style="display:none">Class</span><span data-if="com" style="display:none">Class</span><span data-if="dotnet" style="display:none">classVal</span><span data-if="python" style="display:none">class</span></code></b> (output_control)  </span><span>string(-array) <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">Sequence[str]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (string)</span><span data-if="dotnet" style="display:none"> (<i>string</i>)</span><span data-if="cpp" style="display:none"> (<i>HString</i>)</span><span data-if="c" style="display:none"> (<i>char*</i>)</span></span>
</div>
<p class="pardesc">Results of classifying the character with the
k-NN.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="Confidence" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Confidence</span><span data-if="c" style="display:none">Confidence</span><span data-if="cpp" style="display:none">Confidence</span><span data-if="com" style="display:none">Confidence</span><span data-if="dotnet" style="display:none">confidence</span><span data-if="python" style="display:none">confidence</span></code></b> (output_control)  </span><span>real(-array) <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">Sequence[float]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (real)</span><span data-if="dotnet" style="display:none"> (<i>double</i>)</span><span data-if="cpp" style="display:none"> (<i>double</i>)</span><span data-if="c" style="display:none"> (<i>double</i>)</span></span>
</div>
<p class="pardesc">Confidence(s) of the class(es) of the character.</p>
</div>
<h2 id="sec_result">结果</h2>
<p>如果参数均有效，算子
<code><span data-if="hdevelop" style="display:inline">do_ocr_single_class_knn</span><span data-if="c" style="display:none">do_ocr_single_class_knn</span><span data-if="cpp" style="display:none">DoOcrSingleClassKnn</span><span data-if="com" style="display:none">DoOcrSingleClassKnn</span><span data-if="dotnet" style="display:none">DoOcrSingleClassKnn</span><span data-if="python" style="display:none">do_ocr_single_class_knn</span></code> 返回值 <TT>2</TT> (
      <TT>H_MSG_TRUE</TT>)
    .  If
necessary, an exception is raised.</p>
<h2 id="sec_predecessors">可能的前置算子</h2>
<p>
<code><a href="trainf_ocr_class_knn.html"><span data-if="hdevelop" style="display:inline">trainf_ocr_class_knn</span><span data-if="c" style="display:none">trainf_ocr_class_knn</span><span data-if="cpp" style="display:none">TrainfOcrClassKnn</span><span data-if="com" style="display:none">TrainfOcrClassKnn</span><span data-if="dotnet" style="display:none">TrainfOcrClassKnn</span><span data-if="python" style="display:none">trainf_ocr_class_knn</span></a></code>, 
<code><a href="read_ocr_class_knn.html"><span data-if="hdevelop" style="display:inline">read_ocr_class_knn</span><span data-if="c" style="display:none">read_ocr_class_knn</span><span data-if="cpp" style="display:none">ReadOcrClassKnn</span><span data-if="com" style="display:none">ReadOcrClassKnn</span><span data-if="dotnet" style="display:none">ReadOcrClassKnn</span><span data-if="python" style="display:none">read_ocr_class_knn</span></a></code>
</p>
<h2 id="sec_alternatives">可替代算子</h2>
<p>
<code><a href="do_ocr_multi_class_knn.html"><span data-if="hdevelop" style="display:inline">do_ocr_multi_class_knn</span><span data-if="c" style="display:none">do_ocr_multi_class_knn</span><span data-if="cpp" style="display:none">DoOcrMultiClassKnn</span><span data-if="com" style="display:none">DoOcrMultiClassKnn</span><span data-if="dotnet" style="display:none">DoOcrMultiClassKnn</span><span data-if="python" style="display:none">do_ocr_multi_class_knn</span></a></code>
</p>
<h2 id="sec_see">参考其它</h2>
<p>
<code><a href="create_ocr_class_knn.html"><span data-if="hdevelop" style="display:inline">create_ocr_class_knn</span><span data-if="c" style="display:none">create_ocr_class_knn</span><span data-if="cpp" style="display:none">CreateOcrClassKnn</span><span data-if="com" style="display:none">CreateOcrClassKnn</span><span data-if="dotnet" style="display:none">CreateOcrClassKnn</span><span data-if="python" style="display:none">create_ocr_class_knn</span></a></code>, 
<code><a href="classify_class_knn.html"><span data-if="hdevelop" style="display:inline">classify_class_knn</span><span data-if="c" style="display:none">classify_class_knn</span><span data-if="cpp" style="display:none">ClassifyClassKnn</span><span data-if="com" style="display:none">ClassifyClassKnn</span><span data-if="dotnet" style="display:none">ClassifyClassKnn</span><span data-if="python" style="display:none">classify_class_knn</span></a></code>
</p>
<h2 id="sec_module">模块</h2>
<p>
OCR/OCV</p>
<!--OP_REF_FOOTER_START-->
<hr>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<div class="footer">
<div class="copyright">HALCON算子参考手册 Copyright © 2015-2023 51Halcon</div>
</div>
</div>
</body>
</html>
